LIWC ASSEMDLY PROGRAM 2 
LAP5 



The foUowing Is a description of IAP5> a symbolic conversion 
prog ran for the LINC which uses the L I keyboard for on-line input, 
and the magnetic tapes for storage, v^rorking area, and output. The 
scopes are used to provide readable manuscript, 

i. General Information 

A. Operating Procedure 

1. LAP3 occupies Blocks 300 « 527 of the tape, plus Blocks 
530 and fona'\/lng for "working area" (see Chart IV). The 
tape must be on Unit 0 . 

2. To operate, READ BLOCK 300 Into QUARTER 0, and START at 0, 
A "V will appear on the scopes to Indicate the LAP3 Is ready 
to accept keyboard Input. This Is the only start or restart 
procedure. 

5. Lines of manuscript and roeta are typed Into the 
computer via the keyboard. IAP3 displays on both scopes the 
information being typed, one line at a time, as It Is keyed 
in. 

k. One quarter of the LIKC memory is used to collect manu- 
script. As the quarter is filled, it Is saved on the tape 
beginning in Block 33^ of the v^/orking area. It takes approjti- 
mately 100 - 110 (octal) lines of manuscript to fill one block. 

B. Manuscript Lines 

1, By **manuscrlpt lino" Is meant a line of program, a comment, 
an origin, or an equality. A rr^ta command is not a line of 
manuscript. 

2. A manuscript line may not exceed 17|q struck characters. 
This includes spaces, case shifts, and the terminator. 



5. Manuscript lines are always terminated by striking the 
"End-of-Ulne" key, EOL. Lines vihlcb are too long are auto- 
matically terminated with an ECL by LAP3 and called to the 
attention of the typist. (See Error Detection) 

C. Manuscript Line Numbers 

1. LAP3 assigns a "line number" to every line entered. The 
numbering appears at the upper left of the line on the scopes; 
it is sequential) beginning with 1, and octal. 

2. The number "1" appears as the first line number when the 
Initial "START 0" is executed. After that a new line number 
appears every time the EOL is struck In terminating a manu- 
script line, and the computer waits for the next 1 ine to be 
typed . 

D. Deleting 

1. Hitting the delete key, del, ^111 delete the current line. 
If there Is no current line (i.e. If the computer is displaying 
only a line number), the previous line will be deleted. In 
either case, the line preceding the deleted line will appear 
on the scopes. 

Example: The following sequence will appear on the scopes 
one line at a time as it Is typed: 



I 


ADD 


3 


— hit EOL 


2 


STC 


5 


hit EOL 




JMP 


56 


—hit EOL— - 


k 


STA 




—"hit "del;" line k is deleted— 


5 


JMP 


56 


—-line 3 reappears; type line h again— 


k 


STC 


10 


— hit EOL— 


5 






—next line number appears; hit "del"— 


5 


JMP 


56 


—line k is deleted, line 3 reappears; hit "del"- 


2 


STC 


5 


— line 3 is deleted, line 2 reappears; continue- 
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2. Whatever Is "deleted" is permanently deleted from the 
manuscript. V!hatever is displayed on the scopes is the most 
recent line recorded. In the example above, only lines 1 
and 2 are still part of the manuscript at the end of the 
sequence. 

3. It is not necessary after a delete to hit EOL before con- 
tinuing with the next line. 

E. Display Format 

1. The display format is as in the above example, one line 
at a time. 

2. All keyboard characters (see Chart II) are displayed except 
EOL, del, and CASE. 

3. Characters are displayed as they are struck. 

F. Case Shift 

1. Some keys on the keyboard have been assigned both upper 
and lower cases. The characters in the middle of the keys 
are lovA/er case (see Chart II), and LAP5 normally interprets 
the keyboard as lovjer case. 

2. To select upper case, hit the case shift key, CASE, and 
then hit the upper case character. 

5. The shift is not permanent; It is good for one character 
only . LAP3 returns to lower case automatically. 

11. Line Format and Symbols 

A. Origins 

I. Origins must be spec if le d as octal constants, preceded 




, and terminated with an EOL. 



Example: to specify an origin of 300 on line I, type 



300, 



EOL 



2. Spaces are not permitted anywhere on an origin line except 
before the origin character. 
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3. An origin line may not contain a lino of program. If a 
line of program appears before an origin character on the same 
line, the program line vjlll be omitted. If It appears after, 
the origin will be Interpreted Incorrectly. 

h. Origins may be specified throughout the program. If portions 
of the binary overlap as a result, the later origins take pre- 



5. Conversion Is faster If origins referring to the same quarter 
of memory are entered consecutively In the manuscript » i.e. 

not interspersed with origins referring to different quarters. 
This technique Is not required, but it saves much tape shuffling 
during conversion. 

6. Programs vjlth no initial origin will be located at 20. 
8. Comments 

1. Comments are permitted anyv\)here in the manuscript so long 
as they occupy a line by themselves. 

2. A comment line must begin vjlth the comment character (L). 
It may not begin viith a space. 

5. If a comment is included on a line of program, the program 
line will be omitted during conversion. 



1. Any program Tine (i.e. any manuscript line except origins, 
comments, and equalities) may be tagged. 

2. A tagged line must begin vjlth the tag symbol,^ , It may 



not begin with a space. 

3. Tags are limited to tuo characters. 

a. They must be of the format "number, letter." 

b. The numbers are 1 through 7; letters are capitals, 
A through Z. 

c. Ho spaces are permitted within the tag. 



cedence . 



C. Tags 




e.g. >^2A Is correct; ^ 2A Is not. 



k 



d. Any other format, or acy other combination of characters 
\ru\] be called to the typist's attention, (See Error 
Detection.) 

h-^ llo tag terminator Is required. 

D. Symbolic Operation Mnemonics 

1. All first-order three letter mnemonics for operation codes 
are permitted except MSC- Substitute mnemonics as defined by 
Chart I are also permitted. 

2. The mnemonics used must agree viith Chart I, except that 
the second character may be replaced by any other capital 
letter. 

e. g. JMP or JBP are both acceptable for JUMP. 

JIP is not. 

3* spaces are permitted v/ithin the mnemonic. 

E. Special Symbols 

1. Bit h (the i-bit) is specified symbolically with "i." 

2, Bit 3 (the tape unit bit) Is specified symbolically 
with ''u". 

5. The vertical bar (j ) is used In the second register of 

tape Instructions to separate Of) and BJf. 

e.g. QJJ = 3 and ~ ^5, written ••5 ^5." will be con- 
verted to 30^5» 

a. Spaces are permitted as indicated by apostrophes: 

•5» j »k3* 

k, ''Present Location" is specified symbolically vjith "p." 

5» The 'V and symbols are used as "plus" and "minus" 
in relative addressing and In assigning the sign of a number. 
The "-" symbol Is also interpreted as "dash" for some of the 
meta commands. 

e.g. *567 vjIII be converted to 7210, 
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6. The equality symbol, is used to assign a value to an 



undefined tag in an address f ieid« It may not be used to assign 
a location to a tagged line. 

a. Equalities are permitted anyivhere In the manuscript 
so long as they occupy a line by themselves. 

b. The "letter, number" combination must be on the left 
of the symbol; the numerical assignment on the rights 

c. No spaces are permitted anyiMhere on an equality line« 



Numerals 

1. Numerals on any line of manuscript or in any meta command 
must be octal constants. LAP3 will convert to zero any numbers 
containing an 8 or 9- 

2. Spaces are not permitted between the digits of a number, 
®-9- 7T^5 is legal; Ilk 5 is not. 

Address Field 

1. Symbolic and relative addressing n^rith any combination of 
tags, numerals or "p" is permitted. 

e.g. JMP p-^5 

ADD M\{ 
3C+6-P 

2. Mo spaces are permitted v<fithin the address field. 

3* Undefined tags In the address field are assigned the value 
zero. 

^•9* 3K > when 3X is not defined, vjill be converted 




d. The numerical assignment may not be signed , 
e.g. 6Gs=7TT^ is legal; 
6g=3 is not. 



to 6ooo. 
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For multiply defined to^a, LAP5 v/il1 us© the last one 
entered in the manuscript for the assignment, regardless of 
tAihether it was entered vjlth // or ss. 



e.g. The fo11ov;ing will be converted as shown: 



Location 



Conversion 



100) 
101) 




2005 

6ok2 (\m 6102) 



H. spacing 

1. ^^lo spaces are required anywhere in a line except as desired 
by the typist for scope placement. 

2, Spaces may not be inserted: 



c. Within symbolic operation mnemonics: (S TC). 

d. Between the digits of a number: ( 5 ^5). 

e. Within the address field: {3X- 5). 

f. Within equalities: (H =770) . 

5. Spaces may be inserted between the tag, operation. Index, 
address and vertical bar fields of the line. 
e.g*ii^ 30 STA i 3X 

RDC i u 

2 100 

h. Lines which begin with either a tag (^) or a comment (JJ ) 
symbol are automatically positioned at the left of the scope. 
All other lines will appear toward the middle of the scope. 

I. Error Detection 

I. Some lines which contain errors are detected by the compiler 
while they are being keyed in. These are: 



b. 



a. 



Within tags: (^2 K). 
V/ithIn origins: ( R 
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a. Tagged lines whith begiin with ari iUegal tag or tag 
format . 

b. Lines which are too long. 

c. Lines which contain either a tag or an origin character 
anywhere except first on the line. This includes comments. 

2. Faulty lines are held on the scope and the keyboard is 
briefly loclced. Vihen the keyboard releases, the typist must 
his either: "del,'* which will delete the line, or 

"G," (for GO) which will accept the line as usual. 
The keyboard will repeatedly lock until one of these keys has 
been struck. 

5. Error detection for faulty meta commands is somewhat dif- 
ferent, and will be described below. 

J. Line Format 

1 . Program Lines 

a. The following formats for program lines are permissable 
(spaces optional): 

yy 3K SAE i 5 

5K i SAE 5 
// 3K SAE 5 i 

3K 5 i SAE 

73 RDC u i 

b. The formats 

5K 5 SAE i 
5K 15 SAE 
■// 3K 5X+5 STC 

are permitted, but the space is required between the "5" 
and the "S." 

c. "i" and "u*' may come anywhere on a line, 

d. Generally, any format is acceptable, so long as 
I) Tags come first. 
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2) Numbers and letters are distinguished from * 'number, 
letter" tag combinations. (Examples In b. above.) 

Heta Commands 

A. LAP3 provides nine meta commands for changing, controlling, 
and converting manuscript. 

1. Except for the terminator, meta commands are entered exactly 
as regular manuscript lines. They are displayed with a line 
number and may be deleted with "del" any time before the terminator 
is struck. 

2. The meta command terminator is a Case Shift (CASE) followed 
by the EOL key; this combination is marked META on the keyboard. 

5. Meta commands are executed when they are entered , and auto- 
matically deleted from the manuscript at that time» After a 
meta command is executed, U\P3 returns to normal Input operation, 
displaying the current line number on the scopes. Continue 
typing. 

B. Errors: there are two kinds 

1. When a faulty meta command Is entered with the META key, a 
question mark (?) will appear on the scopes following the command, 
and the keyboard will lock briefly. The only key LAP3 will 
accept at this point is "del." Try again. 

2. Once the command has been accepted, if IAP3 finds that it 
cannot then be executed, a "NCy* will appear on the scopes. 
(This does not happen until the tapes have churned a while 
and UAP3 has at least tried.) The "N(y' will remain on the 
scopes until a key (any key) is struck; LAP3 will return to 
normal input operation displaying the current line number « 

The manuscript entered up to this point Is still Intact (except 
with READ MANUSCRIPT), 
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C. Formats 

1. Meta commands must be at least two letters as specified 
on Chart III. If no numeric parameters follow, any other 
characters may also be typed: e.g., ^'DisplayV may be specified 
With Dl., DiS^ DLSP» D1SPU\Y, etc., so long as the •♦Dl" is 
present.. However, when numeric parameters follow, only two 
letters are permitted. 

2. Spaces are only permitted between the command and the parameters. 

0. Except for "Read Manuscript," ••Copy," and "Convert Manuscripts," 
commands are effective Oniy for manuscript in the working area of 
the tape . 

E. Commands 

K REMOVE Format: RE L^.n^^^^^ 

or: RE UN-LN+n^g^^ 

a. Lines may be removed from the manuscript by typing 
"RE" followed by the tine number, LN, (spaces optional) 
of the first line to be removed. This is followed by a 
comma and the number of lines (octal) to removoi or by 

a "-" and the first line number after the area to be removed. 

Example: To remove 3 lines beginning with line 230, 
when the manuscript presently goes through line kOQ^ 
type 

When the META character is entered, LAP5 will execute 
to command; the rest of the manuscript is automatically 
renumbered , and LAP5 returns to norma 1 i nput operat i on 
by displaying a 576 as the next line number. 

b. When a REMOVE includes the last line in the manuscript, 
any terminating parameter beyond that point will suffice 
to remove the lines. 

Example: To remove the last 10 lines of a manuscript 
which presently ends at line 164, type 



10 



RE 155,10 (or any number greater than 

or RE 155-165 (or any number greater than '^5)^^^^^ 
LAP3 win return with 155 on the scopes as the next 
1 1 ne number . 

c« LAP3 will respond with a "NO** when a REMOVE requests 
a line number (as the initial parameter) not contained In 
tlie manuscript. Example: REMOVE line 20, when the manuscript 
only goes through line 10. 

2. INSERT Format: IN tN»,„ 

META 

END META ^^META 

a. Lines may be inserted in the manuscript f)y typing "IN" 

followed by the line number of the line following the place 

the inserts are to be put. "IN 30^^^^" means "insert the 

following before line 30," A 50 will appear on the scopes 

as the next line number; lines to be Inserted are entered 

at this point just as regular lines. When all the lines 

have been entered, type "EN^«_. '* (as a separate line). 

MET A 

LAP3 will make the inserts and return with the new present 

line number on the scopes 

Example: If 3 lines are to be inserted before line 
^ in a manuscript which is presently 105 lines long, 
the following sequence will appear on the scopes 
(one line at a time): 
106 

IN Type meta command 



EOL 
EOL 
EOL 



Enter the 3 1 ines 



ENOj,--.. y End meta command 

META 



Ml New line number appears; 

continue typing. 
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The conunands on lines 106 and k3 are deleted auto- 
matically when they are executed. 

b. LAP5 permits the user to Insert up to 2 memory quarters 
of information with one INSERT command (approximately 

200 - 220 lines, see Chart IV). Should this much be in- 
serted without terminating the command, it will be auto- 
matically terminated by LAP3> the Inserts will be made, 
and the new line number will appear on the soopes. The 
user may continue Inserting by giving a new INSERT command* 

c, I-AP5 will respond with a "NO" when an INSERT requests 
a line number not contained in the manuscript* Example: 
INSERT before line 50, when the manuscript only goes through 
line ^2. 

3. PACK Fprmat: PAj^^j/j^ 

The meta commands INSERT and REMOVE leave gaps in the manuscript 
wherever the change is made. When several of these commands 
are executed, the number of tape blocks occupied by the manuscript 
can become quite large; the length of time required to execute 
further commands grows proportionally. PACK will condense the 
manuscript; it does not, however, change it in any other way. 
Giving a PACK command when no INSERTS or REMOVES have been 
executed does nothing (except to mal<e the tapes churn)* 

h, DISPLAY Format: 01^^^^^ 

a. This command will display from 1 to 70 (octal) lines 
of manuscript on the scopes, under knob control by the user. 

1) Knob 0 Is used to select the number of lines per 
frame. A request for fewer than 20 (octal) lines will 
produce a single column display of readable size characters. 
Requests for between 20 and 70 lines will be displayed 

In two columns of small size characters* 

2) Knob 1 Is used to sweep through the manuscript, 
advancing the frame one line at a time either forward 
or backv/ard. The middle positions on this knob will 
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hold the display stationary. Hitting the CA5£ key 
when this knob Is on stationary will advance the dis- 
play by one frame (e.g. for taking pictures). 

b. kirie^ are displayed with line numbers. 

c. To terminate the display, hit EOL* LAP5 will return 
to normal input operations* 

d. If a request Is given to DISPLAY an unpacked manuscript, 
LAP3 will PACK It automatically before displaying it. 

5. SAVE MANUSCRIPT Format: SM^^^^ 

a. Manuscript In the working area of the LAP3 tape can be 
saved at any time In any consecutive blocks on either unit. 
Saving manuscript more frequently than you think necessary 
Is recommended. Saving manuscript In the LAP3 area on the 
tape Is not recommended. 

b. An unpacked manuscript Is automatically packed before 
the SM command is executed. 

c. When the user types "SMj^^^^", the following appears 
on the scopes: 

i SAVE i 
I n BLOCKS ! 
! AT BLOCK ? , i 
j UNIT ? 

1) "n," supplied by LAP3, is the number of blocks 
occupied by the manuscript; bocause of a control block 
which accompanies every manuscript, n Is never less than 
2. 

2) The question marks are to be filled In by the user: 
type the block number of the first block where you want 
the manuscript to be put. This will replace the 

on line 3 above. Terminate the line v/lth EOL and type 
the unit number. This will replace the "?'• on line k 
above. Terminate finally with a second EOL and the 
command will be executed. 
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5) If you don't like what you typed, hit "del" and the 
question biark(s) will reappear. One "del" restores 
one "?•'. type the entry again; (Do any "del"s before 
the siecond tOli) If LAP3 db^^rt't like what you typed, 
the question markCs) will reappear automatically when 
the Mots are struck* 

d. After the SAVE, LAP3 will return to normal input operation; 

the manuscript will be as it was before the command was 
executed « 

6. READ MANUSCRIPT Format: RM BN.UN^g^^ 

READ MANUSCRIPT will restore a manuscript which has been SAVED 
to the working area of the LAP5 tape. Type "RM" followed by 
the block number (BM), a comma, and the unit number (UN) specifying 
the present location of the manuscript. 

a. Only manuscripts which have been saved with a SAVE 
MANUSCRIPT can be read with a READ MANUSCRIPT . 

b. When the command is executed, LAP3will return with the 
present line number for the manuscript just read. Continue 
typing. 

c. LAP3 will return with a "NO" when either the BN or the 

UN requested Is illegal, or when there is no SAVED manuscript 
at that location. Hitting a key (any key) at this point 
will return LAP5 to normal input operation, but it will 
return with a "1" as the present line number. Whatever 
you were typing up to the READ command is effectively lost. 

'7' CONVERT Format: CV^g^^ 

The "CV" command converts to binary the manuscript i n the 

working area of the tape . 

a. The binary version will be in blocks 330 - 535 of the 
tape on unit 0 (the LAP5 tape) after conversion. Block 
numbers correspond to memory quarters 0-5 respectively. 



b. After conversion LAP3 will return to normal Input 
operation; the manuscript will be as it was before con- 
version. 



To convert a manuscript NOT in the working area of the tape, 
or to convert several manuscripts together, the command "CMf' 
is used. After the command is given, the following will 
appear on the scopes: 



a. Type the block number(s) specifying the location of 
the beginning of each manuscript to be converted. Separate 
the block number entries with spaces. The numbers will 
appear on the scopes as they are typed; "del** will delete 
them one at a time. U\P3 will delete non-existent block 
numbers when they are typed. 

b. The manuscript(s) specified must all be on the tape 
on unit 0. 

c. Multiple manuscripts are converted together In the order 
In which they are requested; I.e. they are treated as one 
longer manuscript. (This has relevance to origins In the 
manuscripts.) 

d. The manuscrlpt(s) may NOT be in the working area of 
the tape. Only manuscript(s) which have been saved with 
a SAVE MANUSCRIPT my be converted with CM. 

e. Up to 24^Q manuscripts may be selected. 

f. Terminate the manuscript selection with EOL. LAP3 
will convert the manuscrlpt(s) and return to normal Input 
operation. The manuscript in the working area will be 

as It was before the CM command was given. 



8. CONVERT MANUSCRIPTS 



Format: 




CONVERT 

MANUSCRIPTS AT 
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g* As with CV> the binary conversion will be in blocks 
530 - 555 on unit 0, block numbers corresponding to memory 
quarters 0 - 5> respectively. 

h. A "NO" will appear If LAP3 finds that any of the blocks 
specified does not contain the beginning of a SAVED manu«- 
script. 

9. COPY Format: CP^^^^ 

This command permits the user to copy any number of blocks to 
any place on either unit, (it does not apply only to manu- 
script.) V/hen the command is given, the following appears on 
the scopes: 



a. Fill In the question marks as indicated, terminating 
each line entry with EOL. The command will be executed 
when the last EOL Is typed after line 6 above. Hitting 
"del" will delete entries, one at a time, I.AP5 will delete 
illegal entries automatically. 

b. Since LAP5 can only copy 5 blocks at a time (because 

of memory limitations), care should be taken not to overlap 
the block numbers when requesting a COPY* Example: 
Requesting a COPY of 6 blocks from block 550 to block 555 
on the same unit will not work. Requesting a COPY of 5 
blocks, however, from block 550 to block 551 on the same 
unit will work. (Obviously, if the units are different 
the COPY will bie successful.) 

c. After the COPY, LAP3 will return to normal input operation; 
the manuscript in the working area will be as it was before 
the command. 



COPY \ 

? BLOCKS 1 

FROM BLOCK ? I '\ 

UNIT ?, { 

TO BLOCK i " ) 

UNIT ? I- J 



Requested location 



Number of blocks to move 



Present location 



NOTE: Chart I is Order Code 
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Chart III* LAP3 Heta Commands 



Command 


Requ i ired Format 


May be followed by other 
characters 


1 . Remove 


RE IN^n 
RE. LN4N 


No 


2. Insert 


IN LN 




End Meta 


EN 




5.. Pack 


nil 

PA 




Display 


Dl 


Yes 


5. Save Manuscript 


SM 




S. Read Manuscript 


RM BN .UN 


No 


7. Convert 


CV 




B. Convert 
Manuscripts 


CM 


Yes 


?• „ Copy 


CP 





Chart IV. U\P5 Tape Allocation 



Block 


Al location 


300-522 


LAP5 


323 


Temporary Storage 


52^325 


Inserts 


5^-327 


LAP5 


530-553 ^ 


Binary 


33^ 


Temporary Storage 


535 


Manuscript Control 
Block 


556 and ff. 


Manuscript 



CHART ft 




SPACE 



I 

G 

u 

EOL 



Comment 

Tag 

Origin 
Tape Unit 

End of Line 



CASE 



del 



Case Shift 

1-bit 
Equal tty 
Delete 

QNjBN 



LINC ill KEYBOARD CODING 

29^ 
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